home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
u_man
/
cat3
/
Tk
/
managegeom.z
/
managegeom
Wrap
Text File
|
1998-10-30
|
7KB
|
133 lines
TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy((((3333TTTTkkkk)))) TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy((((3333TTTTkkkk))))
NNNNAAAAMMMMEEEE
Tk_ManageGeometry - arrange to handle geometry requests for a window
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
####iiiinnnncccclllluuuuddddeeee <<<<ttttkkkk....hhhh>>>>
TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy(_t_k_w_i_n, _m_g_r_P_t_r, _c_l_i_e_n_t_D_a_t_a) |
AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
Tk_Window _t_k_w_i_n (in) Token for window to be managed. |
Tk_GeomMgr *_m_g_r_P_t_r (in) Pointer to data structure |
containing information about the|
geometry manager, or NULL to |
indicate that _t_k_w_i_n's geometry |
shouldn't be managed anymore. |
The data structure pointed to by|
_m_g_r_P_t_r must be static: Tk keeps|
a reference to it as long as the|
window is managed.
ClientData _c_l_i_e_n_t_D_a_t_a (in) Arbitrary one-word value to pass|
to geometry manager callbacks.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy arranges for a particular geometry manager, described
by the _m_g_r_P_t_r argument, to control the geometry of a particular slave
window, given by _t_k_w_i_n. If _t_k_w_i_n was previously managed by some other
geometry manager, the previous manager loses control in favor of the new
one. If _m_g_r_P_t_r is NULL, geometry management is cancelled for _t_k_w_i_n.
The structure pointed to by _m_g_r_P_t_r contains information about the
geometry manager:
ttttyyyyppppeeeeddddeeeeffff ssssttttrrrruuuucccctttt {{{{
cccchhhhaaaarrrr ****_n_a_m_e;;;;
TTTTkkkk____GGGGeeeeoooommmmRRRReeeeqqqquuuueeeessssttttPPPPrrrroooocccc ****_r_e_q_u_e_s_t_P_r_o_c;;;;
TTTTkkkk____GGGGeeeeoooommmmLLLLoooossssttttSSSSllllaaaavvvveeeePPPPrrrroooocccc ****_l_o_s_t_S_l_a_v_e_P_r_o_c;;;;
}}}} TTTTkkkk____GGGGeeeeoooommmmMMMMggggrrrr;;;;
The _n_a_m_e field is the textual name for the geometry manager, such as ppppaaaacccckkkk
or ppppllllaaaacccceeee; this value will be returned by the command wwwwiiiinnnnffffoooo mmmmaaaannnnaaaaggggeeeerrrr.
_r_e_q_u_e_s_t_P_r_o_c is a procedure in the geometry manager that will be invoked
whenever TTTTkkkk____GGGGeeeeoooommmmeeeettttrrrryyyyRRRReeeeqqqquuuueeeesssstttt is called by the slave to change its desired
geometry. _r_e_q_u_e_s_t_P_r_o_c should have arguments and results that match the
type TTTTkkkk____GGGGeeeeoooommmmRRRReeeeqqqquuuueeeessssttttPPPPrrrroooocccc:
ttttyyyyppppeeeeddddeeeeffff vvvvooooiiiidddd TTTTkkkk____GGGGeeeeoooommmmRRRReeeeqqqquuuueeeessssttttPPPPrrrroooocccc((((
CCCClllliiiieeeennnnttttDDDDaaaattttaaaa _c_l_i_e_n_t_D_a_t_a,,,,
TTTTkkkk____WWWWiiiinnnnddddoooowwww _t_k_w_i_n))));;;;
The parameters to _r_e_q_u_e_s_t_P_r_o_c will be identical to the corresponding
parameters passed to TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy. _c_l_i_e_n_t_D_a_t_a usually points to a
data structure containing application-specific information about how to
PPPPaaaaggggeeee 1111
TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy((((3333TTTTkkkk)))) TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy((((3333TTTTkkkk))))
manage _t_k_w_i_n's geometry.
The _l_o_s_t_S_l_a_v_e_P_r_o_c field of _m_g_r_P_t_r points to another procedure in the
geometry manager. Tk will invoke _l_o_s_t_S_l_a_v_e_P_r_o_c if some other manager
calls TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy to claim _t_k_w_i_n away from the current geometry
manager. _l_o_s_t_S_l_a_v_e_P_r_o_c is not invoked if TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy is called
with a NULL value for _m_g_r_P_t_r (presumably the current geometry manager has
made this call, so it already knows that the window is no longer
managed), nor is it called if _m_g_r_P_t_r is the same as the window's current
geometry manager. _l_o_s_t_S_l_a_v_e_P_r_o_c should have arguments and results that
match the following prototype:
ttttyyyyppppeeeeddddeeeeffff vvvvooooiiiidddd TTTTkkkk____GGGGeeeeoooommmmLLLLoooossssttttSSSSllllaaaavvvveeeePPPPrrrroooocccc((((
CCCClllliiiieeeennnnttttDDDDaaaattttaaaa _c_l_i_e_n_t_D_a_t_a,,,,
TTTTkkkk____WWWWiiiinnnnddddoooowwww _t_k_w_i_n))));;;;
The parameters to _l_o_s_t_S_l_a_v_e_P_r_o_c will be identical to the corresponding
parameters passed to TTTTkkkk____MMMMaaaannnnaaaaggggeeeeGGGGeeeeoooommmmeeeettttrrrryyyy.
KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
callback, geometry, managed, request, unmanaged
PPPPaaaaggggeeee 2222